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The PRM-Q is a "Q-Bus Plus" DMA interface for the Priam Winchester 
disk drives used .with t±ie Priam "Smart Interface". It provides 
a direct, easy-to-program connection between the Q-Bus and the 
Smart Interface. The PRM-Q can operate one Smart Interface 
which can control four drives. 

The PRM-Q provides direct programmed I/O access to registers in 
the disk controller, it handles multi-sector DMA transfers through 
the full 22-bit address range of the Q-Bus Plus, allows for partial 
sector transfers and handles interrupts for byte-count-zero, bus 
error and disk controller attention conditions. In addition, the 
PRM-Q contains an on-board PROM for easy bootstrapping. 

PRIAM SMART INTERFACE DISK CONTROLLER 

The PRIAM "Smart Interface" contains eight read-only regist"e:E^| -and 1 
eight write-only registers. The PRM-Q accesses the register's as 
t^/70 srouDS of ^^JT "rp;=)H— nnl v/iatti 1"P— nnl V rp Pi fit pr nairs. A select 
bit in the DMA control /status register determines which group of 
four is to be accessed. The registers consist of a conmand/ status 
register (CSR) , a data buffer (DBF) , six parameter registers aind 
six result registers. The protocol required by the controller to 
cause it to perform an operation is as follows: 

• Load the parameter registers 

• Load the comnand into the CSR 

• Wait for attention flag 

• Read status from CSR and result register 

• Send completion acknowledge command to CSR 
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PRIAM SMART INTERFACE DISK CONrRQTJKR- rnnf-iriiipd 

The transfer imst be completed within four seconds of the first data 

request or the controller will detect a transfer timeout error. 

The disk controller can transfer multiple sectors as a result of 
one command. A maximum of approximately 64KB (127 sectors) can 
be transferred this way. The disk controller always transfers data 
in multiples of whole sectors. It cannot transfer partial sectors. 

PR^H^ REGISTERS 

The PRM-Q responds to eight register (full word) addresses in the 
I/O page. Four of these registers correspond to the disk controller 
registers. One register is not used. The other three registers 
provide control over the DMA and interrupt functions of the PRM-Q inter- 
face, and select which group of four disk controller registers is 
to be accessed. The registers are: 

-Smart Interface Registers (Read Only)- 



Relative 
Address 


Low Group 
(SEL = 0) 


High Group 
(SEL = 1) 





Result 5 


Result 1 


2 


Result 4 


Result 


4 


Result 3 


Disk Data 


6 


Result 2 


Controller Status 



-Smart Interface Registers (Write Only)- 



Relative 
Address 


Low Group 
(SEL = 0) 


High Group 
(SEL = 1) 





Parameter 5 


Parameter 1 


2 


Parameter 4 


Parameter 


4 


Parameter 3 


Disk Data 


6 


Parameter 2 


Controller ( 






PRM-Q REGISTERS- continued 

-PK^hQ Interface Registers- 
Relative 
Address Function 

10 Not Used 

12 Interface Control/Status (ICS) 

14 Interface Memory Address (IMA) 

16 Interface Byte Count (IBC) 

The ICS register contains the following control functions: 
Control Functions 

• Enable external interrupt (disk controller attention) 

• Enable internal interrupt (byte-count-zero or bus error) 

• DM transfer direction 

• Disable IMA incrementing 

• Reset disk controller 

• Select disk controller register group 

• High six bits of the 22-bit memory address 

The "Disable IMA incrementing" control bit is used to allow partial 

sector transfers into program memory \^^ile accommodating the disk 

controller's requirement for full sector transfers. For example, when 

readinp" a partial sector the memorv address is set to txDint into the 

desired data transfer area, the byte count register is set for the 

desired number of bytes, internal interrupt is enabled and the read 

operation in initiated, when byte-count-zero occurs the memory address 

is reset to point to an unused byte in memory, the "Disable IMA incrementing" 

bit is set and IBC is cleared. The bytes remaining in the sector are 

then all transferred into the unused byte. A similar operation can 

be followed to write partial sectors with zero fill. 
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PRM-Q REGISTERS- cont inued 

The disk controller reset bit niust be cleared or the disk controller 
will be held in a reset condition. The disk controller register 
select bit (SEL) determines ^ich of two register groups is currently 
selected for DMA and prograrnned I/O transfers. The high six bits 
of memory address act as the high order extension of the 16-bit 
IMk register. When the IMA is incremented from 177777 to 0, the 
carry out causes this six-bit extension to be incremented. 

The ICS register provides the following status information: 
Status Bits 

• External interrupt request flag 

• Internal interrupt request flag 

• Controller ready 

• Bus error 

The IM. register provides the low order 16-bits of the 22-bit memory 
address, the IMA is incremented before the first transfer so it must 
be loaded initially with one less than the memory address of the 
first data byte to be transferred. Note that this subtraction 
operation must be applied to the full 22-bit address value. For 
example, to transfer into location of memory, the IMA must be loaded 
with 177777 and the high six bits in the ICS must be loaded 77. 

The IBC register allows for transfers of up to 65KB of data. It is 
an up-counter and it stops counting \dien it reaches the value 177777. 
This is the byte-count-zero condition which asserts the internal 
interrupt request. The IBC must be loaded initially with the ones- 
complement of the number of bytes to be transferred. 
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Chapter 1 
INTRODUCTION 



The Priam Winchester handler is a device handler for RTll 
which works with any of the Friarr' Winchester disk drives. The 
handler can he easily adapted to work with the various drives 
which are available now and which will become available in the 
future. 

The handler utilizes the full storage capacity of the 
drives. Defect mapping (if used) is transparent to the handler. 
A disk forrratting prograrr is provided which interleaves logical 
sectors to maximize block transfer rate on consecutive block 
transfers. 

The Priajn handler works with the PRM-C interface 
manufactured by Peritek Corporation. The FRM-Q is connected to 
Priam's "Smart Interface" disk controller. Up to four drives may 
be connected to the disk controller. 

The interrupt service routine runs at interrupt level 5. 
Therefore, if the PRM-0 is used with an LSI-11/23 CPU which has 
multi-level interrupts, the interrupt request level of the PRM-Q 
should be changed to BIRQ5. (See PRM-Q User's Manual for 
details). This is not a mandatory change. 

This handler works with RTll Version 4. It will work with 
the SJ, FB and XM monitors. The handler performs exactly like a 
standard RTll handler and its use is completely transparent to 
the applications programmer. 

The sysgen options supported by the Priam handler are memory 
management and error logging. 

The device name used is 'VP' and the device code is octal 
370. 

I_-4 l-ofical Unit Configuration 

Each physical drive can be treated as a single logical unit 

or it can be divided into a number of smaller logical units. 

RTll allows a device handler to have up to ei^ht logical units. 

Each logical unit is limited to 32M3 in size. 
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handlep/distIisution kit 



1 1^1 Surriniary " ' " 

The Priam handieris distributed on HX01 compatible single 
sided, single density diskette; Source files for the handler are 
included so the user can generate his ovn handler if desired. 

11^2 Contents of Diskette 

The distribution package contains the following files: 

VP.MAC - Handler source file 
VPCND.MAC - Randier conditional file 

WP..C.OM , -.- .Command file used to generate handler 

WF.OBJ - Handler object file 
WP.LST v ' - Handler listing; file 
WP.SYG - Eiecutable handler 

VfPFMT.SAV - Disk formatting program 

EHRTXT .MAC - -Register names for error log report writer 

WFDVN. SAV - Turns 'Of f nower to all drives 
WPDWN.MAC - Source 



11^^ Restrictions : ' t ^ 

The executable handler contained in the distribution kit 
will work with the standard monitors (PTllSJ, PT11F3, RTllBL) as 
provided in the V4 release kit. It will not work with user gen 'd 
systems with any of the following options enabled: extended 
memory, error logging, timer supDort. The executable handler 
will only work with hardware (interface and drives) as specified 
in the handler conditional file. List the handler conditional 
file to see if it matches your hardware configuration. 



If the executable handler is not compatible with either your 
operating system or your hardware then a new handler will have to 
See Chapter IV for instructions on how to do this. 



be generated 



i.I_!.^ getting Cnrline 

There are 
handler ud and 



several steps which must be taken to get the Priam 
running as the system device. 
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a) forrrat the disk drive (s ) in 512 lyte format usins the 
progrart! WPFHTi This is described in Section II 1. 3. 

b) Generate the appropriate handler to suit the 
hardware/software environment and the desired logical 
unit configuration. This is described in Chapter IV. 

c) Copy the generated handler to the systern device on the 
existing. system. .Use the commands: 

.COFY/STS VP.STG SYrWP.SYS 
.INSTALL ¥P 

It is now possible to use the target disk as a 
non-system device on the existing system. Initialize 
the directories on the target disk and verify that files 
can be written tq and read back from the drive. 

d) Copy the system files and other important files to the 
.-:targ€t disk. : .3e sure to include the SWAP file, 

monitors, handlers, utility programs, etc. 

e) Execute the boot .copy operation as follows: 

.COPY/BOO? VP:RTllxx WP: 

Where xi represents SJ, FB, or XM. The drive is now a 
. . bootable system device. - : " 

f) Bring up the new system by extent In-g a soft boot using 
the monitor command: 

.BOOT VF: 

g) Alternately, bring up the system ' by executing the 
hardware boot. In .micro-ODT type: 

(37770000. - . 

If the address of the PRM-Q card is n en-standard be sure 
to use the correct address.- 

Note that a soft boot can be performed on any logical unit but 
the hardware boot always uses drive 0t, logical unit 0. 



II±5 Powering Down 



^^The program WPDVN.SAV outputs the command "Sequence Power 
Down" to all drives and then halts. It is advisable to execute 
this program before turning off power to the Smart Interface and 
drives. The program source is included in case the user wants to 
eliminate the halt or change the controller address. 
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1. Chapter MJ 
DBIVE PEEPAFATION 



lllA i^izsical Connection 

The PHM-Q User's Manual provides information on how^ to 
option the PEM-0, how to- i-.nstall it, connect it to the Srrart 
Interface, and how to ^v-erify-r-that it is working properly. 

lll^^ PlJ-Y? Options 

The importa;^t drive options to select are the drive mirr"ber 
and nurrber of sectors'' per track. The Friair! handler addresses 
drives in numerical order. If only one drive is connected it 
must r-espond ,to drive address- 0. If two drives are bein^ used 
they must respond to drive raddjFs'ses and 1, and so forth. 

The drives must he set up' to use 512 byte sectors. Choose 
the appropriate number of sectors per track to give 512 byte 
sectors. 

Write protect must be disabled. 

HIjl^ Prize lormatting 

The. drives,, as. shipped by Priam, may not be In the nroper 
512 byte format for use^ by BTll. A program included on the 
diskette handles formatting for any of the Priam drives. It does 
not use defect mapping. 

There are three purposes for fcrfnattins a disk. They are: 

1. Set up the disk with 512- byte sectors for use by RTll. 

2. Interleave logical sectors for maximum data transfer 
rate on multi-block transfers. 

3. Flag all sectors containing media defects so they cannot 
be read or written by PTll. 

III^3a Operating Procedures 

The formatting program is WPPviT.SAV. It is an interactive 
program which requires the user to specify the controller 
address, drive number and format desired. The dialogue is shown 
' below with sample answers for a standard FHM-Q and a 3350 drive: 
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?ri;ajr: i?<3rTin-atting Program (31-MAE-Sl) 

Snter. . . . 

Controller address (octal) = 177100 

Drive numter to te formatted = 

Starting cylinder = 

Ending cylinder = 560 

Total bytes per -secrdt • = W^5^^^~' 

Interleave fat^tof^ ' = 4 

Logical units- per drive ■ = 4 

All values entered are decimal num'bers except for the 
controller address which is octal. Starting and ending cylinders 
specify the cylinder range to "be 'forma it ed. Suggested values to 
use are shown in the tah lie- "below: 



Drive- ' 


Majxiflrirm: ^ 


-In t er 1 e a v e Factor 


Total 


Model 


Cylinder;^ • 


-■ 41Z? Vl/23 


Sytes^Sectgr 


1070 


189: * . 


- ■ .^ . ■ - 3 


548 


2050 


' 524 1 c 


r -:^- - : 3:^ - • : 


582 


3450 


524 


4 3 


582 ^ ^ 


3350 


550 


5 4 


t74 S(ct 


5650 


1120' : - - 


^ ^ ^^■5 ; ■■: ■ 4 ■■ 


^ ^^^^ 


15450 


1120 


5 4 





The total "bytes per sector parameter indicates the physical 
size of a sector inciudi-ng headeir, filler,; data, CRC and gap. 
This number is used in calculating- the se'c'tor location of a media 

defect. ■ / " '■"■ -O , : 1 : ••:. ^ .:-; ■ :. .: r ^i - ' ■: 




The logical units per drive specified should correspond to 
the num"ber of logical units per drive which will "be used "by the 
RTll handler (see Section IV.l). This value Is used to determine 
the location of defective sectors in terms of BTll logical unit 
and "block num'bers. - , . ^ .. .. •- 

Once the Darameters have been entered the program then reads 
the drive type and drive parameters from the Smart Interface and 
displays them on the console device as follows? 







Drive Information 




Type 


Model 


Heads Cyls S/Trk 


S/Drive B/S 


1 


3350 


3 561 34 


57222 512 
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If an error occurs -when 'reading the drive type " or parameters or 
if the sector size • isnot 512 "bytes, then an error message is 
printed and the- program --ahorts . ' 

If the drive type -and •'parameters are read successfully and 
if the sector size is 512 bytes then the program will request the 
name of a file or device- to receive information on the fornriatting 
process, . including ithe drive= information and the 
logical-to-physical sector map. 

Output file = LP: 

If the null string (return, only) is entered then no output is 
generated. Jf ..a, device -or -file name is entere-d, the output is 
directed to that f-ile or <rievlce. 

The Prog-ram then requiests: . 

Type 'GO' to proo-eed:? 

When the user types GO (followed by return)" the program begins 
eiecution. While formatting, the program produces no output to 
the console excep-t on errDrncondltlons.- Formatting can take a 
long time {up to 25 minutes on large drives) so rest assured that 
the program is working and 'vait for it to finish. 

IIIi55 lorQ^lIiliS Eiocess 

The program formats the, disk in five steins, executing all 
five operations on a given trackr. before proceeding to the next 
track. Formatting begins on the starting cylinder specified and 
continues to the last cyllaider' oh the^ drive. 

-The operations used in formatting the drive are as follows: 

a) Format Disk 

Writes headers for~ 512 byte sectors . 

b) Write Data 

Writes:512; bytes of data to every sector on the track. 

c) Read Skip Defect Record 

' Determines if - there are any defects on the track. 

d) Interleave Logical Sectors 

Rewrites the headers in interleaved order. 

e) Verify 

Reads back the entire disk and lists any sectors with 
faulty CRC's on ID or data. 

If an error is encountered the program types out a short 
:;haracter string identifying the operation in progress, followed 
by seven bytes in octal. These values represent the status 
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specifying the head and cylinder numher 
program proceeds to the next tracK... 



result registers 

If three errors 

ge is iDrinted out 

decimal, and the 



- > 'If defects are encountered dn'^a track the verify operation 
is "bypassed since it will Always result in error messages. 



III.i?? Prograrn Output 



The output 'Which goes" to "%he user 'ST)eclfied device or file 
includes ' the ' input - -.parr^roete"^rs,* -' the "drive information, and a 
sector map which show^s ' the *- pi^ysical ' to logical sector 
correspondence. If the numler of sectors i^er track is even the 
map is the same for all Ttracfes on ^^^ d'evfce." If the numher of 
sectors per track is odd, the mat) is different for each track en 
a cylinder hut all cylinders- af^e-: exactly the same. A sample 
sector map for a 3353 drive with 34 sectors per track and 
-:intt&r leave fat^tcr -- 



Friam Formatting Program: '(SI -MAR -81") 



Controller address ' ■=^ ^y77tm - 
Drive number - 

Starting cylinder = 
Ending cylinder = 560 
Total hytes per sector = WM^ 56c 
Interleave factor ^ ^ : ?=' 4p '^^ ^ ' ? 
Logical units per driver^ 4 



, .- Drive Inf o-rma.ti'o'n 
Type Model Heads Cyls S/Trk 
1 3350 :. .3 : ^ 561 : : :' ; 34 



S/Drive B/S 
57222 ^ 512 



Sector- Map^' ' 

PHYSICAL SECTOR - 

12 3 4 5 6 7 8- -'9 10- 11 12 13 14 15 16 17 18 19 



tieaa 






























1 


14 


15 


28 


29 


8' 


:9 


22 


23- 


2 


1 





1 


14 


15 


28 


29 


8 


9 


22: 


?23^ 


2 


2 





1 


14 


15 


28 


29 


8 


9 


22 


23 


2 



3' 16 17 30 31 10 11 24 25 
3 IS t? 30 31 10 11 24 25 
3 16 17 30 31 10 11 24 25 



PHYSICAL SECTOH ^ ^"" - 

20 21 22 23 24 25 26 27 28 29 30 31 32 33 
Head 

4 5 16 19 32 33 12 13 26 27 6 7 20 21 

1 4 5 18 19 32 33 12 13. 25 27 5 7 20 21 

2 4 5 18 19 32 33 12 13 25 27 6 7 20 21 
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III .4 Media Defects 



TiPFMT does not use defect mapping "because it is inefficient 
and it reduces the total num"ber of cylinders available for use. 
ETll 's bad block capability is a much more satisfactory method to 
take care of defects. When the skip defect record indicates 
media defects en a given track, the formatting program generates 
error .me_^ssages to -Inform where the defects are. These 
error ViWssaces .take; .the f6r,m: - •, ' 

Bad sector .at unit 1 hlock 6533. 



or: 



Bad sscto^rs at uni-t 0- blacks 102^. to- 135. 



The formatting program writes Invalid sector ID's on sectors 
ccnteinine defects, sa it- is -ifnpossible for HTil to read or write 
unreliable sectors. Tilsr entsuTes that error.s will ' o<;cur if a 
program ever tries to write into a defective area, not just at 
some future time when a program attempts to read; b^ick the data. 

The user should create ".BAD" files at T the locations 
specified- as bad sectors so no HTll program will ever attemT)t to 
use those areas. 
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Chapter IV 

SENEEATING THg JANDLER 



The WPCND:mac file (fefiries several "parameters which affect 
the assembly of the handler. By changing these parameter values 
the user can customize the handler for his particular 
application. The standard -co'ndlt tonal file is shown helow: 

; WPCND.MAC lS-FEB-81 

; PRIAM EANDLEH CONDITIONAL ASSEMBLY. OPTIONS (HTll V4.0) 

? " : FOR THE Pirn rTSr COBPORATrON PRM-d" 



.;PPM-Q i^rriRFACE 

:¥PVEC=:^ 3?€- '- -' 



DE^FINITIO^^ ■ . . ..,. , 

.?...■ : ■ ^;JSTAfiI)A1lIt DEVICE: BASE" AJ5DPESS. 

' - 'lS¥A?NBtel) INTERRUPT VEXJTDR.: ,. 



• T\ T c.ir 



WPEEAD= 3 
\«PCTLS=' 561. 
WPSPT=: 34. ' 



VET Lvri rnjNb 



; NUMBER OF HEADS 

VNtmBER OF CYtlNDlERS TO USE 

;NUM3ER OF SECTt)RS PER" TRACK 



,OGICAL UNIT CONFIGURATION 



NDRVS= 
NLUN = 



;NUMBER OF DRIVES ON THIS CONTROLLER 
;NUMBER of LOGICAL UNITS PER DRIVE 
;N0TE: NDR?S*NLUN MUST BE LESS THAN OR EQUAL TO 8 



;HANDLER OPTIONS 
.•.EIS= 



;eis available? (=i if eis is available) 



The PRM~0 interface definitions do not have to he changed 
unless the user has changed the jumiser selectable addresses on 
the PRM-Q board. If the addresses have been changed, be sure 
that the definitions correspond to the actual addresses on the 
board. 

The disk geometry definitions depend on the type of drive 
being used. Sample values to use for different drive models are: 



Drive: 


1070 


3450 


3350A 


3350B 


5650 


Cylinders: 


190 


525 


561 


561 


1121 


Heads: 


4 


5 




3 


3 


Sectors: 


22 


23 


34 


35 


35 



If the user implements defect mapping on his 
number of cylinders to use will have to be reduced. 



drives, the 



Chapter IV Page 10 



The logical ^UB-it confl^tjr'at ton must le, determined hy the 
user, feased on his Teqiuirem^ents. , The numher of dri can range 
from 1 to 4V i The numl3errof logical units per drive can range 
from 1 to 8. Hp«ever,= the. total .numher of logical .units (number 
of logical units per drive times numher of drives) must "be less 
than or equal to eight. Also rememher that no logical unit can 
contain more than 55K "blocks (32MB). 

The handler option is simple. If the ...EIS parameter is 
set to a non-zero value the DI7 instruction will he used in place 
of a software divide loop. This shortens the handler by a few 
words, and speeds up the entry section slightly. . 



Hi^ Sysg§B Qptlons 



There are three sysgen options which affect device handlers: 
extended meiTjory/,; error lOjBjging, and tim^r support. If any of 
these' options Is "beiJig used, the system conditional file 
■{SYCNP.MAG ) - creat^ed when the v system yas geh'd will have to he 
included in 4;he ass€mhly of the handler. 

Copy the SYCND file to the disk being used for the WP 
handler-assembly.. Then edit the command file VP.COM. Change the 
line: 

MACHO/OBJ-:WP/ALLOC:10/LIST:WP/CRO:S/.S.HOW;MEB WPCND+WP 

to read: 

MA,CRa/OBJ:!iifP/ALLOC:10/LIST:WP/CRC:S/SHOV:MEB SYCND+WPCND+VP 

' 'I;f -error lo,gging. is used then the file EPvRTIT.MAC supplied 
with the VP, distribution kit will have to be used in place of the 
standard fl^le .:Whi.ch came with the V4 ., release kit. ERETIT is 
assembled, and-. then:4:inked with ERROUT as described in the RTll 
1^4 ^0' Software. Support .^manual, page 7-37. 

Gerigrating The Handler 

Once -the procedures specified in the previous two sections 

have been, completed, -the handler can be generated by executing 

therlndireet command file WP.COM. The files generated by this 
operation are: 

. ■ IfP.OBJ, Wf.LST, WP.SYG, \jp.MAP 

If : memory management was enabled these files should be 
renamed: 

WPX.OBJ, WPX.LST, WPX.STG. WPX.MA? 



